home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 2001 November / SGI IRIX Installation Tools & Overlays 2001 November - Disc 3.iso / relnotes / impactcomp / ch04.z / ch04
Text File  |  2001-10-10  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        4.  _D_o_c_u_m_e_n_t_a_t_i_o_n__E_r_r_o_r_s
  9.  
  10.        _C_L__I_M_P_A_C_T__B_U_F_F_E_R__A_D_V_I_S_E
  11.  
  12.           +o A Compression Library (CL) parameter,
  13.             _C_L__I_M_P_A_C_T__B_U_F_F_E_R__A_D_V_I_S_E, has been added to allow an
  14.             application to inform either the OCTANE Compression or
  15.             IMPACT Compression device driver that it is not
  16.             required to perform the processor cache write-back or
  17.             invalidate operations for the uncompressed data (frame)
  18.             ring buffer.
  19.  
  20.             This parameter is for use when an application is
  21.             performing a memory to memory operation and it does not
  22.             access the uncompressed data for any reason.
  23.  
  24.             An example of this type of operation is the dmplay
  25.             applet (source code available in the
  26.             impactcomp.sw.examples image) display on graphics mode
  27.             (dmplay -p graphics).  In this case, the applet doesn't
  28.             touch or modify the uncompressed data, but just
  29.             provides the images for transfer to the graphics
  30.             subsystem.
  31.  
  32.             The value CL_BUFFER_ADVISE_NOACCESS notifies OCTANE
  33.             Compression or IMPACT Compression that the application
  34.             will not access the uncompressed ring buffer. The value
  35.             CL_BUFFER_ADVISE_ACCESS notifies OCTANE Compression or
  36.             IMPACT Compression that the application may access the
  37.             uncompressed data buffer, and that processor cache
  38.             operations are required to ensure data integrity.
  39.  
  40.             If an application wishes to utilize this feature, there
  41.             are some restrictions it must abide by:
  42.  
  43.                +o The uncompressed data (frame) ring buffer must be
  44.                  marked uncacheable via the _c_a_c_h_e_c_t_l(_2) system
  45.                  call.
  46.  
  47.                +o The uncompressed data (frame) ring buffer must
  48.                  have been flushed via the _c_a_c_h_e_f_l_u_s_h(_2) system
  49.                  call.
  50.  
  51.                +o The application must not, for any reason, access
  52.                  any data in the uncompressed data (frame) ring
  53.                  buffer.
  54.  
  55.             Modifications have been made to the _c_l_C_r_e_a_t_e_B_u_f(_3_d_m)
  56.             routine to ensure that a ring buffer created via that
  57.             mechanism is page aligned and padded out to the end of
  58.             a page.  This ensures an application's ability to use
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.             cachectl(2) & cacheflush(2) successfully.  Applications
  75.             should make every attempt to use _c_l_C_r_e_a_t_e_B_u_f() to
  76.             create their buffers.
  77.  
  78.           +o The R10000 processor on Indigo 2 does not support
  79.             uncacheable memory.  It is not possible to guarantee
  80.             that the user application will not access the memory on
  81.             that system.  Therefore it is not supported to use this
  82.             mode on the R10000 Indigo 2 system.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.